home *** CD-ROM | disk | FTP | other *** search
/ New Star Software Collection / NSS_Collection.iso / 5-029 turbo debugger and assem / disks.7z / 4 / README < prev    next >
Encoding:
Text File  |  1988-08-28  |  14.6 KB  |  377 lines
  1.                        WELCOME TO TURBO ASSEMBLER 1.0
  2.                        ------------------------------
  3.  
  4. This README file contains important, last minute information
  5. about Turbo Assembler 1.0. The HELPME!.DOC file on the TURBO
  6. ASSEMBLER/INSTALLATION disk also answers many common Technical
  7. Support questions.
  8.  
  9.  
  10. TABLE OF CONTENTS
  11. -----------------
  12.  
  13.   1. How to Get Help
  14.   2. Installation
  15.   3. Important Notes
  16.   4. Manual Additions and Corrections
  17.   5. Files on the Disks
  18.  
  19.  
  20. 1. HOW TO GET HELP
  21. ------------------
  22.  
  23.   If you have any problems, please read this file, the HELPME!.DOC
  24.   file, and the Turbo Assembler manuals first. If you still have a
  25.   question and need assistance, help is available from the following
  26.   sources:
  27.  
  28.   1. Type GO BOR on the CompuServe bulletin board system for
  29.      instant access to the Borland forums with their libraries of
  30.      technical information and answers to common questions.
  31.  
  32.      If you are not a member of CompuServe, see the enclosed special
  33.      offer, and write for full details on how to receive a free
  34.      IntroPak containing a $15 credit toward your first month's on-
  35.      line charges.
  36.  
  37.   2. Check with your local software dealer or users' group.
  38.  
  39.   3. Write to us at the following address:
  40.  
  41.      Borland International
  42.      Turbo Assembler Technical Support
  43.      1800 Green Hills Road
  44.      P.O. Box 660001
  45.      Scotts Valley, CA  95066-0001
  46.  
  47.      Please remember to include your serial number or we will be
  48.      unable to process your letter.
  49.  
  50.   4. If you have an urgent problem that cannot wait and you have sent
  51.      in the license agreement from the front of your manual, you may
  52.      call the Borland Technical Support Department at (408) 438-5300.
  53.      Please have the following information ready before calling:
  54.  
  55.      a. Product name and serial number on your original distribution
  56.         disk.  Please have your serial number ready or we will be
  57.         unable to process your call.
  58.  
  59.      b. Product version number. The version number for Turbo Assembler
  60.         is displayed when you run the program.
  61.  
  62.      c. Computer brand, model, and the brands and model numbers of any
  63.         additional hardware.
  64.  
  65.      d. Operating system and version number. (The version number can
  66.         be determined by typing VER at the MSDOS prompt.)
  67.  
  68.      e. Contents of your AUTOEXEC.BAT file.
  69.  
  70.      f. Contents of your CONFIG.SYS file.
  71.  
  72.  
  73. 2. INSTALLATION
  74. ---------------
  75.  
  76.   This disk contains a program called INSTALL.EXE that will
  77.   assist you with the installation of Turbo Assembler 1.0. There
  78.   are two options for installation:
  79.  
  80.   1. Hard Disk - This option allows you to pick the subdirectories
  81.      where the files will be loaded.
  82.  
  83.   2. Floppy Disk - This option will install the files necessary to
  84.      use Turbo Assembler on a two-drive system.  Be sure to have
  85.      four formatted disks ready before you start.
  86.  
  87.   To start the installation, change your current drive to the one
  88.   that has the install program on it and type INSTALL.  You will
  89.   be given instructions in a box at the bottom of the screen for
  90.   each prompt. For example, if you will be installing from drive
  91.   A:, type
  92.  
  93.     A:
  94.     INSTALL
  95.  
  96.   You should read the rest of this README file to get further
  97.   information about this release before you do the installation.
  98.  
  99.  
  100. 3. IMPORTANT NOTES
  101. ------------------
  102.  
  103.   o Additional tips and answers to many common questions will be found
  104.     in the text file HELPME!.DOC, which has been installed to the same
  105.     location as this file (README). You can use the README.COM utility
  106.     to view the HELPME!.DOC file by giving the following command:
  107.  
  108.       README HELPME!.DOC
  109.  
  110.   o If you will be running INSTALL on a laptop or any other system
  111.     that uses an LCD display, you should set your system into black
  112.     and white mode before running INSTALL. You can do this from DOS
  113.     with the following command line:
  114.  
  115.       mode bw80
  116.  
  117.     or, you can force INSTALL to come up in black and white mode by
  118.     using the /b switch:
  119.  
  120.       install /b
  121.  
  122.   o Changed Switches for OBJXREF:
  123.  
  124.     The /O option (object files directory) has been changed to
  125.     the /D (directories) option. The switch now allows for
  126.     multiple search directories to be specified. The new syntax
  127.     follows:
  128.  
  129.      OBJXREF /Ddir1[;dir2[;dir3]]
  130.  
  131.        or
  132.  
  133.      OBJXREF /Ddir1 [/Ddir2] [/Ddir3]
  134.  
  135.     OBJXREF will search each of the directories in the specified
  136.     order for all object and library files. If no /D option is
  137.     used, only the current directory will be searched. However,
  138.     if a /D option is used, the current directory will NOT be
  139.     searched unless it is included in the directory list. For
  140.     example, to first search the BORLAND directory for files and
  141.     then search the current directory, you would type
  142.  
  143.       OBJXREF /Dborland;.
  144.  
  145.     If multiple search directories are specified and a file
  146.     matching the file specification is found, OBJXREF will
  147.     include the file as part of the cross-reference. OBJXREF will
  148.     only continue to search the other directories for the same
  149.     file specification if the file specification contains
  150.     wildcards.
  151.  
  152.     A new option has been added to allow you to specify an output
  153.     file where OBJXREF will send any reports generated. The new
  154.     option is the /O option, and it has the following syntax:
  155.  
  156.       OBJXREF myfile.obj /RU /Ofilename.ext
  157.  
  158.     By default, all output is sent to the console.
  159.  
  160.   o Turbo Linker (TLINK) Notes:
  161.  
  162.     1) When linking with the /V option, TLINK will initialize all
  163.     segments. If you have a program that runs differently when
  164.     linked with debug information, you have an uninitialized
  165.     variable somewhere.
  166.  
  167.     2) TLINK loads last any segments of class 'STACK' even if
  168.     they are part of DGROUP.
  169.  
  170.  
  171. 5. MANUAL ADDITIONS AND CORRECTIONS
  172. -----------------------------------
  173.  
  174.   Additions and corrections to the manual will be found in the text
  175.   file MANUAL.DOC, which has been installed to the same location as
  176.   this file (README). You can use the README.COM utility to view the
  177.   MANUAL.DOC file by giving the following command:
  178.  
  179.     README MANUAL.DOC
  180.  
  181.  
  182. 6. FILES ON THE DISKS
  183. -----------------------
  184.  
  185.   TURBO ASSEMBLER/INSTALLATION
  186.   ----------------------------
  187.   INSTALL  EXE  -  Installation program
  188.   README   COM  -  Reads this README
  189.   TASM     EXE  -  Turbo Assembler
  190.   TCREF    EXE  -  Turbo Assembler cross-reference utility
  191.   MAKE     EXE  -  Program for managing projects
  192.   TLINK    EXE  -  Borland Turbo Linker
  193.   TLIB     EXE  -  Borland Turbo Librarian
  194.   OBJXREF  COM  -  Object file cross-reference utility
  195.   GREP     COM  -  Turbo GREP program
  196.   TOUCH    COM  -  Program that updates a file's date and time
  197.   MANUAL   DOC  -  Last minute additions and corrections to the manual
  198.   HELPME!  DOC  -  Text file with the answers to many common
  199.                    questions. Please read HELPME!.DOC before
  200.                    contacting Technical Support
  201.   README        -  This file
  202.   MMACROS  ARC  -  MASM Mode Macros
  203.     BIOS.INC    -  Equates representing the BIOS services
  204.     DOS.INC     -  Equates representing the DOS services
  205.     KBD.INC     -  Equates representing the IBM PC keyboard keystrokes
  206.     MBIOS.MAC   -  Macros used to interface with the IBM PC BIOS. MASM Mode
  207.     MDOS.MAC    -  Macros to interface with DOS. MASM Mode
  208.     MMACROS.MAC -  General macros. Masm Mode
  209.  
  210.   TURBO DEBUGGER UTILITIES/EXAMPLES
  211.   -----------------------------------------
  212.   This diskette also contains files for use with the Turbo Debugger.
  213.   Please see the Turbo Debugger README and manuals for a complete
  214.   description of these files.
  215.  
  216.   TDCONVRT EXE  -  Turbo Debugger utility
  217.   TDPACK   EXE  -  Turbo Debugger utility
  218.   TDNMI    COM  -  Turbo Debugger utility
  219.   UNPACK   COM  -  Program to unpack the .ARC files
  220.   TDEXMPL  ARC  -  Packed file that contains Turbo Debugger examples
  221.   TAEXMPL1 ARC  -  Ideal mode example and macros
  222.     BIOS.INC     - Equates representing the BIOS services
  223.     BIOSMAC.DOC  - Documentation for macros implemented in ?BIOS.MAC
  224.     DEMO1.BAT    - Batch file to make Whereis.exe
  225.     DOS.INC      - Equates representing the DOS services
  226.     DOSMAC.DOC   - Documentation for macros implemented in ?DOS.MAC
  227.     IASCIIZS.ASM - Routine to display an ASCIIZ string
  228.     IBIOS.MAC    - Ideal mode macros used to interface with the IBM PC BIOS
  229.     IBYTECPY.ASM - Routine that copies an array of bytes from one
  230.                    location to another
  231.     IDELCHAR.ASM - Routine that deletes n characters from a
  232.                    Pascal-style string starting at position i
  233.     IDOS.INC     - Type declarations used to interface with DOS
  234.     IDOS.MAC     - Macros to interface with DOS. Ideal Mode
  235.     IFINDBYT.ASM - Routine that searches an array of bytes looking for a
  236.                    value; routine that returns the length of an ASCIIZ string.
  237.     IFINDFIL.ASM - Routine that does a recursive search of a hard disk
  238.                    looking for a file
  239.     IFINDREP.ASM - Routine that searches through an array of bytes,
  240.                    replacing all instances of a value with another value.
  241.     ILOCSTRG.ASM - Routine that searches through memory looking for the
  242.                    nth Pascal-style string
  243.     IMACROS.MAC  - General macros. Ideal Mode
  244.     IPARAM.ASM   - Routines to return the # of command-line parameters and
  245.                    the contents of an individual parameter
  246.     IPARSEFN.ASM - Routine that parses a file name into Drive,
  247.                    Path, and File spec
  248.     ISKPWHIT.ASM - Routine to advance a pointer past any whitespace in
  249.                    an array of bytes
  250.     IWHEREIS.ASM - Main module for Whereis program
  251.     IWHGLOBL.INC - Global declarations for Whereis
  252.     IWRITEPS.ASM - Routine to display a Pascal-style string
  253.     KBD.INC      - Equates representing the IBM PC keyboard keystrokes
  254.     WHEREIS.DOC  - Documentation for Whereis file locator program
  255.     WHEREIS.MAK  - Make file for creating Whereis.exe using the Make utility
  256.     WHUSAGE.INC  - Usage screen text
  257.  
  258.   TAEXMPL2 ARC  -  Simplified (FILT) and standard segmentation (SHOW87)
  259.                    examples
  260.     CONVERT1.INC - Converts from binary numbers to strings
  261.     CONVERT2.INC - Converts from floating point to integer numbers
  262.     DEMO3.BAT    - Batch file to make Filt.exe text filter program
  263.     DEMO2.BAT    - Batch file to build Show87
  264.     FILT.ASM     - Text filter main file
  265.     FILT.DOC     - Documentation file for Filt.exe text filter program
  266.     FILT.MAK     - Make file for creating Filt.exe using the make utility
  267.     FILT.RSP     - Linker response file for linking Filt.exe
  268.     GLOBALS.INC  - Declares procedures and symbols needed by the modules
  269.                    of FILT
  270.     OBYTEHI.ASM  - Processes the current high byte value in AL
  271.     OBYTELOW.ASM - Processes the current low byte value in AL
  272.     OBYTENRM.ASM - Processes the current normal byte value in AL
  273.     OCMDNUM.ASM  - Parses the command line
  274.     OERREXIT.ASM - Handles the printing of error messages
  275.     OFCREATE.ASM - Creates or truncates a file; the file is opened
  276.                    for writing
  277.     OFILALOC.ASM - Allocates a read/write buffer
  278.     OFILCLOS.ASM - Closes a file
  279.     OFILEFIL.ASM - Fills a read buffer
  280.     OFILFREE.ASM - Deallocates a read/write buffer
  281.     OFILREAD.ASM - Reads from a file
  282.     OFILWRIT.ASM - Writes to a file
  283.     OFLFLUSH.ASM - Flushes the write buffer
  284.     OFOPENR.ASM  - Opens a file for reading
  285.     OFOPENW.ASM  - Opens a file for writing
  286.     OLOCASE.ASM  - Routine converts a letter to lowercase
  287.     OPARSCMD.ASM - Parses the command line
  288.     OPRCBYTE.ASM - Processes a byte
  289.     OPROCDOC.ASM - Processes an entire document, one line at a time
  290.     OPROCLIN.ASM - Processes a line
  291.     OSETOPTN.ASM - Sets input buffer size; sets output buffer
  292.                    size; sets the byte to end lines; clears all
  293.                    tab stops; sets a tab stop; truncates lines to
  294.                    a specified length; sets the left margin;
  295.                    deletes the left margin; displays a help
  296.                    message
  297.     OSPACES.ASM  - Stores a specified number of spaces at
  298.                    particular location
  299.     OSTORSPC.ASM - Stores any currently stored spaces
  300.     OSTORTAB.ASM - Stores a tab character if there are any spaces
  301.                    to compress
  302.     OTABCLR.ASM  - Clears all tab stops
  303.     OTABNEXT.ASM - Returns the number of spaces to the next tab stop
  304.     OTABRSET.ASM - Sets tap stops every eight columns
  305.     OTABSET.ASM  - Sets a tap stop at a specified column location
  306.     OUPCASE.ASM  - Routine converts a letter to uppercase
  307.     SHOW87.ASM   - Standard Segmentation Demo Program
  308.     SHOW87.DOC   - Documentation for Show87 8087 register display
  309.                    program
  310.     VIDEO1.INC   - Routines to display text and control the screen
  311.     VIDEO2.INC   - Routines to display formatted text strings
  312.  
  313.   CHAPXMPL ARC  -  Examples Programs from the Manual
  314.  
  315.      Note: This file is not automatically unpacked when Turbo Assembler
  316.            is installed to a hard disk. To unpack these files you will
  317.            first need to switch to the drive and subdirectory containing
  318.            this file and then give the command
  319.  
  320.            unpack /r chapxmpl
  321.  
  322.     HELLO.ASM    - Pg   9
  323.     HELLO2.ASM   - Pg  13
  324.     HELLOPRN.ASM - Pg  15
  325.     REVERSE.ASM  - Pg  16
  326.     ECHOCHAR.ASM - Pg  56
  327.     MODCHAR.ASM  - Pg  80
  328.     DELAY.ASM    - Pg  88
  329.     DSLYSTR.ASM  - Pg 109
  330.     USE_ES.ASM   - Pg 110
  331.     STDSEG.ASM   - Pg 115
  332.     STRINGS.ASM  - Pg 132
  333.     PRNTSTR.ASM  - Pg 175
  334.     CNTWORDS.ASM - Pg 181
  335.     MAIN.ASM     - Pg 208
  336.     SUB1.ASM     - Pg 208
  337.     PLUSONE.C    - Pg 285
  338.     PLUSONE.ASM  - Pg 285
  339.     SQRETBLE.C   - Pg 289
  340.     SQRTBLE2.C   - Pg 289
  341.     STRINGUP.C   - Pg 295
  342.     DOTOTAL.ASM  - Pg 308
  343.     SHOWTOT.C    - Pg 309
  344.     DOTOTAL2.ASM - Pg 309
  345.     TOGLFLAG.C   - Pg 316
  346.     TOGFLAG.ASM  - Pg 316
  347.     CALLCT.C     - Pg 330
  348.     COUNT.ASM    - Pg 330
  349.     COUNTLG.ASM  - Pg 332
  350.     CALCAVG.C    - Pg 337
  351.     AVERAGE.ASM  - Pg 337
  352.     SAMPLE.PAS   - Pg 347
  353.     ASMPROC.ASM  - Pg 347
  354.     TSAMPLE.PAS  - Pg 348
  355.     HEXTEST.PAS  - Pg 361
  356.     HEXSTR.ASM   - Pg 360
  357.     XCHANGE.PAS  - Pg 363
  358.     XCHANGE.ASM  - Pg 363
  359.     ENVTEST.PAS  - Pg 366
  360.     ENVSTR.ASM   - Pg 366
  361.     SCROLLH.PRO  - Pg 391
  362.     SCROL.ASM    - Pg 392
  363.     MYPROLOG.PRO - Pg 395
  364.     MYASM.ASM    - Pg 395
  365.     ADDPRO.PRO   - Pg 397
  366.     ADD.ASM      - Pg 397
  367.     SHOWMESS.PRO - Pg 399
  368.     FROM_ASM.ASM - Pg 400
  369.     SHOWNEW.PRO  - Pg 400
  370.     FROM_NEW.ASM - Pg 401
  371.     FUNC.PRO     - Pg 402
  372.     IFUNC.ASM    - Pg 402
  373.     MULT_C&D.ASM - Pg 475
  374.     PRIMES.ASM   - Pg 526
  375.     MASEXMPL.ASM - Pg 555
  376.     IDLEXMPL.ASM - Pg 557
  377.